package com.example.question.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.question.entity.QuestionSet;
import com.example.question.entity.Positions;

/**
 * 题目集服务接口
 * 继承MyBatis-Plus的IService，提供基础的CRUD操作
 * 定义题目集相关的业务操作方法
 * @author 颜殿
 */
public interface QuestionSetService extends IService<QuestionSet> {
    /**
     * 添加题目集
     * 创建一个新的题目集
     * @param questionSet 题目集实体，包含题目集的基本信息
     * @return 添加是否成功
     */
    boolean addQuestionSet(QuestionSet questionSet);

    /**
     * 删除题目集
     * 根据ID删除指定的题目集
     * @param id 要删除的题目集ID
     * @return 删除是否成功
     */
    boolean deleteQuestionSet(Integer id);

    /**
     * 修改题目集
     * 更新指定题目集的信息
     * @param questionSet 包含更新信息的题目集实体
     * @return 更新是否成功
     */
    boolean updateQuestionSet(QuestionSet questionSet);

    /**
     * 根据职位ID分页查询题目集
     * 获取指定职位相关的题目集分页列表
     * @param pageNum 页码，从1开始
     * @param pageSize 每页记录数
     * @param positionId 职位ID，可为null表示查询所有职位
     * @return 分页结果，包含题目集列表和分页信息
     */
    Page<QuestionSet> pageByPosition(Integer pageNum, Integer pageSize, Integer positionId);

    /**
     * 根据职位级别分页查询题目集
     * 获取指定职位级别相关的题目集分页列表
     * @param pageNum 页码，从1开始
     * @param pageSize 每页记录数
     * @param positionLevel 职位级别，可为null表示查询所有级别
     * @return 分页结果，包含题目集列表和分页信息
     */
    Page<QuestionSet> pageByPositionLevel(Integer pageNum, Integer pageSize, String positionLevel);

    /**
     * 根据状态查询题目集
     * 获取指定状态的题目集分页列表
     * @param pageNum 页码，从1开始
     * @param pageSize 每页记录数
     * @param status 状态值，可为null表示查询所有状态
     * @return 分页结果，包含题目集列表和分页信息
     */
    Page<QuestionSet> pageByStatus(Integer pageNum, Integer pageSize, Integer status);

    /**
     * 多条件分页查询题目集
     */
    Page<QuestionSet> pageByCondition(Integer pageNum, Integer pageSize, Integer positionsId, String level, Integer status);

    /**
     * 根据题目集ID获取关联的职位信息
     * @param id 题目集ID
     * @return 关联的职位信息
     */
    Positions getPositionByQuestionSetId(Long id);
} 